home *** CD-ROM | disk | FTP | other *** search
/ Shareware Extravaganza - Disc 1 / ShareWare Extravaganza 1 of 4 (The Ultimate Shareware Company).iso / grprogs / grafwk52.exe / DRIVERS.DOC < prev    next >
Text File  |  1991-03-14  |  15KB  |  299 lines
  1. This file contains information about super VGA drivers 
  2. and dot matrix printer drivers for Graphic Workshop.
  3.  
  4.  
  5.  
  6. Dot matrix printer drivers for Graphic Workshop
  7. _______________________________________________
  8.  
  9. This version of Graphic Workshop includes the following dot 
  10. matrix printer drivers. All the supplied drivers print to LPT1. 
  11. You can redirect this with the DOS MODE command. If you write a 
  12. custom driver you can have it print to any port you like.
  13.  
  14. Note that while the external printer driver facility was 
  15. implemented in Graphic Workshop to support dot matrix printers, 
  16. you can write a driver to support pretty well any output device, 
  17. including film recorders, FAX boards and so on.
  18.  
  19. EPSNFX80.PDR    This is a driver for the generic Epson FX-80 
  20.                 modes. It will work with many dot matrix 
  21.                 printers, although with far less resolution than 
  22.                 some newer printers can manage.
  23.  
  24. EPSNFX80.ASM    This is the source code for the generic Epson FX-
  25.                 80 driver, for use as a starting point in writing 
  26.                 your own custom driver. If you come up with a 
  27.                 printer driver of your own, please send us the 
  28.                 source and we'll include it in future releases of 
  29.                 Graphic Workshop with suitable credit.
  30.  
  31. GEMINI.PDR    This is a driver for the 480 dot wide mode of the 
  32.                 arcane Star Micronics Gemini 10X. The output from 
  33.                 this printer is pretty ugly. The double 
  34.                 resolution graphics mode of the Gemini 10X is a 
  35.                 bit narrow, and pictures come out with badly 
  36.                 distorted aspect ratios, so we didn't use this 
  37.                 mode.
  38.  
  39. PROPRINT.PDR    This driver was written by Jim Dougherty for the 
  40.                 IBM ProPrinter. We haven't tasted it, but it 
  41.                 looks good.
  42.  
  43.         The following drivers were all written by Chris 
  44.                 Rogers of Ashtree Software. They're particularly 
  45.                 slick, in that they will ask you what resolution 
  46.                 you want to print at. We have not tested these, 
  47.                 but they look to be well written.
  48. EPNLQ132.PDR    -    Epson LQ series printers, wide carriage
  49. EPNLQ80.PDR    -    Epson LQ series printers, narrow carriage
  50. EPNLQ950.PDR    -    Epson LQ-950 printers
  51. EPNLX132.PDR    -    Epson LX series printers, wide carriage
  52. EPNLX80.PDR    -    Epson LX series printers, narrow carriage
  53. IBMX24.PDR    -    IBM Proprinter X24, narrow carriage
  54. IBMXL24.PDR    -    IBM Proprinter X24, wide carriage
  55. PAN24132.PDR    -     Panasonic KX-P1124, wide carriage
  56. PAN2480.PDR    -     Panasonic KX-P1124, narrow carriage
  57. PAN9132.PDR    -     Panasonic 9 pin printers, wide carriage
  58. PAN980.PDR    -     Panasonic 9 pin printers, narrow carriage
  59. ROL24132.PDR    -     Roland 24 pin printers, wide carriage
  60. ROL2480.PDR    -     Roland 24 pin printers, narrow carriage
  61. ROL9132.PDR    -     Roland 9 pin printers, wide carriage
  62. ROL980.PDR    -     Roland 9 pin printers, narrow carriage
  63.  
  64. Registered users of Graphic Workshop wishing to write their own 
  65. drivers are welcome to whatever help we can supply. We can't 
  66. teach you to program in assembler over the phone, but we can 
  67. probably help you with basic questions and suggest ways around 
  68. any problems you encounter.
  69.  
  70.  
  71. Super VGA card drivers for Graphic Workshop
  72. ___________________________________________
  73.  
  74. NOTE: As of version 2.4 of Graphic Workshop, the internal 
  75. structure of the super VGA drivers changed a bit. The old drivers 
  76. will no longer work with GWS.EXE. New versions of all the current 
  77. drivers are included with this release... delete your old 
  78. drivers.
  79.  
  80. MORE NOTES: As of version 2.7, all the drivers were changed 
  81. slightly. This involved using a slightly different technique for 
  82. setting the VGA palette to make palette adjustments from within 
  83. the VGA 256 colour mode look nicer. Older drivers... written after 
  84. version 2.4 of Graphic Workshop... will still work, but you'll 
  85. see a bit of screen trash when you adjust the VGA palette.
  86.  
  87. This version of Graphic Workshop includes the following drivers:
  88.  
  89. AMST1512.DRV    This driver was developed by Marcel Ward in 
  90.                 Aberystwyth, Wales. It allows owners of Amstrad 
  91.                 PCs with the custom sixteen colour display cards 
  92.                 supplied with these systems to look at colour 
  93.                 images. We haven't tested this driver, lacking an 
  94.                 Amstrad, but the source code looks right. The 
  95.                 source code in A86 is also included.
  96.  
  97. TSENG.DRV    This driver was developed Gregory Weeks and 
  98.                 should work with most super VGA cards based on 
  99.                 the Tseng Labs chips. We haven't tested this 
  100.                 driver, but it looks to be well written. Run 
  101.                 TSNGINST.EXE to configure the driver for the 
  102.                 various Tseng chips. The source code for the 
  103.                 driver is included in TSENG.A86. This is an A86 
  104.                 source file, and may need a bit of fine tuning to 
  105.                 assemble with MASM. This driver was updated by 
  106.                 the author as of the version 5.0 release of 
  107.                 Graphic Workshop.
  108.  
  109. VGA640.DRV      This is a very clever driver by Gregory Weeks 
  110.                 (the author of TSENG.DRV, above) which displays 
  111.                 640 pixel wide 256-colour files on a 320 pixel 
  112.                 wide screen by leaving out every alternate pixel. 
  113.                 As the author notes in his remarks in the 
  114.                 VGA640.A86 file, nothing is free and some detail 
  115.                 is lost. However, if you have a VGA card with no 
  116.                 640 pixel wide, 256-colour mode... or one which 
  117.                 there is no driver for as yet... you'll find that 
  118.                 this driver is often preferable to the stock 320 
  119.                 by 200 pixel MCGA mode.    
  120.  
  121. ORCH512.DRV    This driver was developed by Richard A. Bross for 
  122.                 the Orchid 512K boards. This is a Tseng based 
  123.                 board as well. It supports up to 800 by 600 
  124.                 pixels at 256 colours. Once again, we haven't 
  125.                 tested this driver but it looks to be properly 
  126.                 written. The source is in ORCH512.ASM.
  127.  
  128.         Thanks to all these authors for these drivers.
  129.  
  130. TIGA.DRV    This driver supports true 24-bit colour on a 
  131.                 Hercules Graphic Station card. Note that a VGA 
  132.                 card only actually does 18-bit colour. The 24 bit 
  133.                 colour mode of the Graphic Station card has a 
  134.                 resolution of 512 by 480 pixels. Its aspect ratio 
  135.                 isn't all that good, but you can fiddle the 
  136.                 monitor controls... for most monitors... to get 
  137.                 pretty reasonable pictures. Surprisingly, 24-bit 
  138.                 colour does not make an inordinate difference to 
  139.                 most GIF files, as few scanners really make use 
  140.                 of this degree of colour resolution. This driver 
  141.                 is a bit slow, because of the way the Graphic 
  142.                 Station card requires its video memory be updated 
  143.                 in this mode. In answer to an obvious question, 
  144.                 this driver should work on other cards supporting 
  145.                 the Texas Instrument TIGA chip, but no 
  146.                 promises...
  147.  
  148. TRIDENT.DRV    This is a driver for the Trident VGA graphic 
  149.                 cards. It drives the card in its 640 by 400, 256 
  150.                 colour mode, and will work with cards having 256 
  151.                 kilobytes or more of onboard memory. We 
  152.                 originally found the Trident card this driver was 
  153.                 developed on in a Sun Moon Star 386SX we were 
  154.                 loaned. It turned out that the monitor provided 
  155.                 with this computer would not sync in the 640 by 
  156.                 400 256 colour mode, even though the card was 
  157.                 doing fine. If you have this system, you probably 
  158.                 won't be able to use this driver unless you 
  159.                 spring for a multisync monitor.
  160.  
  161. TRDNT512.DRV    This will drive Trident cards with 512 kilobytes 
  162.                 of memory on board to 480 lines in 256 colour 
  163.                 mode. This is even harder on cheap monitors. We 
  164.                 smoked one while developing this driver... 
  165.                 fortunately, it was on loan.
  166.  
  167. VIDEO7.DRV    This is a driver for the Headland Technologies 
  168.                 Video Seven VRAM and Video Seven 1024i cards. It 
  169.                 supports the 640 by 480 line 256-colour mode. It 
  170.                 uses the standard VGA and EGA 16-colour and 
  171.                 monochrome modes... we decided not to implement 
  172.                 the 1024 by 768 16-colour mode. There are very 
  173.                 few 16-colour images around which could take 
  174.                 advantage of this mode, but there are a lot of 
  175.                 monitors which cannot.
  176.  
  177. PARAPLUS.DRV    This is a full featured driver for the Western 
  178.                 Digital Paradise Plus card. This driver also 
  179.                 works with the Dell Super VGA card, which is 
  180.                 actually a Paradise 16-bit card.
  181.  
  182. PARAPRO.DRV    This is a driver for the Paradise Professional 
  183.                 card (and clones thereof). It supports both the 
  184.                 640 by 400 and 640 by 480 pixel, 256 colour 
  185.                 modes.
  186.  
  187. DELLVGA.DRV    This is a version of PARAPLUS.DRV, above. It has 
  188.                 been modified not to use the 800 by 600 pixel EGA 
  189.                 and monochrome modes of the Paradise card, as 
  190.                 this causes the super VGA monitor on a Dell to 
  191.                 click a (loud) internal relay every time it 
  192.                 changes modes. If you don't mind the relay, or 
  193.                 you want the 800 by 600 modes, use PARAPLUS.DRV, 
  194.                 above.
  195.  
  196.                 Note: rumour has it that some Dell systems have 
  197.                 been shipped with Headland Video 7 cards rather 
  198.                 than Paradise cards. If your Dell system is so 
  199.                 equipped... or if you can't get GWS to work in 
  200.                 the super VGA modes with one of the above two 
  201.                 drivers... try VIDEO7.DRV.
  202.  
  203. PARADELL.DRV    This is a 512K version of DELLVGA.DRV, that is, a 
  204.                 Paradise driver with the 800 by 600 monochrome 
  205.                 mode disabled.
  206.  
  207. ATIWONDR.DRV    This is a driver for the ATI VGA Wonder and ATI 
  208.                 VGA Edge cards. It drives the 256 colour screen 
  209.                 in the 400 line mode, and will work with cards 
  210.                 having 256K on them. The upper 256K on half meg 
  211.                 cards will be ignored by this driver.
  212.  
  213. ATI512.DRV    This is a driver for ATI Wonder cards having 512K 
  214.                 of memory on board. It will display pictures in 
  215.                 up to 800 by 600 pixel resolution, selecting 
  216.                 among the three available 256 colour display 
  217.                 modes based on the dimensions of the image to be 
  218.                 viewed.
  219.         
  220. GRAFDRV.DRV    This is a stock VGA card driver. You might want 
  221.                 to use this if there is no super VGA card driver 
  222.                 available for your card, however, as it handles 
  223.                 the 16-colour and monochrome modes in potentially 
  224.                 more useful ways than the internal VGA driver of 
  225.                 Graphic Workshop does.
  226.  
  227. VGA400.DRV    This is a "gadget" driver for a stock VGA card 
  228.                 which reprograms the beast into an undocumented 
  229.                 320 by 400 line mode. It should work on any VGA 
  230.                 card, but being undocumented one cannot be sure. 
  231.                 In any case, while interesting, this mode has 
  232.                 such a squashed aspect ratio that it's not really 
  233.                 useful for anything. In addition, having heavily 
  234.                 interlaced memory, it's painfully slow to update.
  235.  
  236. VGA480.DRV    This is another undocumented mode. It gets still 
  237.                 more on the screen, with still more distortion.
  238.  
  239. To use one of these drivers, use GWSINSTL to select EXTERNAL for 
  240. display type and enter the path to your driver in the path name 
  241. field at the bottom of GWSINSTL screen. This should be the 
  242. complete path, including the drive letter. Graphic Workshop does 
  243. not assume that driver file names end in .DRV... you can call 'em 
  244. anything you like.
  245.     The name of the driver you've loaded should appear in the 
  246. F10 "About" window when you're running GWS.EXE.
  247.     
  248.  
  249. Writing your own driver
  250.  
  251. Also included with this version of Graphic Workshop is 
  252. GRAFDRV.ASM, the source code for GRAFDRV.DRV. This file can be 
  253. used as the boilerplate for writing your own super VGA card 
  254. driver. You will need a pretty good grasp of assembly language 
  255. and the hardware specific details of the card you want to write a 
  256. driver for to get this together. This file should be assembled 
  257. with Microsoft's MASM assembler, version 4.0 or better.
  258.     The following batch file is useful in assembling 
  259. GRAFDRV.ASM into GRAFDRV.DRV... or any other driver you happen to 
  260. write.
  261.  
  262. MASM %1 %1 NUL NUL
  263. IF ERRORLEVEL 1 GOTO PROBLEM
  264. LINK %1 @AUTOLINK
  265. EXE2BIN %1 %1.DRV
  266. DEL %1.EXE
  267. DEL %1.OBJ
  268. :PROBLEM
  269.  
  270.     The file AUTOLINK must be present... it contains four 
  271. carriage returns, that is, four blank lines.
  272.     In future releases we hope to include a number of SVGA 
  273. drivers with Graphic Workshop. If you write one using the 
  274. GRAFDRV.ASM skeletal driver and care to send us the source, we'll 
  275. be pleased to include it with future releases, with suitable credit.
  276.     Registered users of Graphic Workshop who want to write 
  277. their own drivers are welcome to the source code for all the 
  278. above drivers... you might find some of the techniques used in 
  279. them helpful in writing your driver. The only conditions are that 
  280. you must be a registered user and we'd like to have the source 
  281. code for the driver you write when you get it working... we'll 
  282. include the object file in with future releases of Graphic 
  283. Workshop.
  284.     We'll be happy to give you whatever help we can in 
  285. writing your driver, too.
  286.     If you want the driver source files, please phone or 
  287. write us and we'll send 'em off to you.
  288.  
  289.  
  290. Custom drivers
  291.  
  292. We've been asked on a few occasions whether we'll write custom 
  293. drivers for Graphic Workshop on behalf of various interested 
  294. parties. We might be able to, depending on time and whathaveyou. 
  295. If you really want a specific SVGA driver for Graphic Workshop... 
  296. for example, if you want to licence it for inclusion with a 
  297. particular card or computer... and you can't get it together 
  298. yourself, contact us. Our address is in GRAFWORK.DOC.
  299.